Skip to content

docs: add Kerberos multi-domain authentication to WinRM how-to#1819

Merged
fdevans merged 7 commits into
rundeck:4.0.xfrom
jgarces-pd:docs/kerberos-multi-domain-winrm
Jun 16, 2026
Merged

docs: add Kerberos multi-domain authentication to WinRM how-to#1819
fdevans merged 7 commits into
rundeck:4.0.xfrom
jgarces-pd:docs/kerberos-multi-domain-winrm

Conversation

@jgarces-pd

@jgarces-pd jgarces-pd commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new Kerberos Authentication section to docs/learning/howto/how2winrm-rundeck.md
  • Documents the krb5.conf.d drop-in file pattern for supporting multiple Active Directory domains
  • Explains the UPN username format requirement (user@REALM) to avoid pywinrm falling back to NTLM
  • Covers required GPO settings, including the WSMAN/* wildcard for credential delegation across domains
  • Includes a verification step using kinit and klist

Context

Tracked in RSE-89 — customers running Process Automation in multi-domain AD environments encountered Kerberos auth failures when using DOMAIN\user username format or a single-realm krb5.conf. This doc covers the working configuration validated against two domains.

Test plan

  • Review krb5.conf examples for accuracy
  • Verify GPO table paths match current Windows Server UI
  • -Confirm node XML attribute names match current PyWinRM plugin version
  • Confirm node YAML attribute names match current PyWinRM plugin version
  • Check doc renders correctly in VuePress

Fixes

RSE-89

🤖 Generated with Claude Code

Adds a new section covering Kerberos authentication with pywinrm for
environments with multiple Active Directory domains. Documents krb5.conf
drop-in file pattern, UPN username format requirement, and GPO settings.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@jgarces-pd jgarces-pd requested a review from a team June 16, 2026 13:51
g3nsvrv and others added 3 commits June 16, 2026 10:00
…fication

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Include all six delegation policies (standard + NTLM-only variants) and
explain why both sets are needed for reliable multi-domain operation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@jgarces-pd

Copy link
Copy Markdown
Contributor Author

@forrestrd @fdevans FYI
I have tested this configuration using two separated domains, with their own nodes, and works perfect.

g3nsvrv and others added 3 commits June 16, 2026 10:54
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

@jgarces-pd jgarces-pd left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

everything is good to go.

@fdevans fdevans added this to the 6.0.0 milestone Jun 16, 2026
@fdevans fdevans merged commit 2fd33ab into rundeck:4.0.x Jun 16, 2026
1 of 3 checks passed
@jgarces-pd jgarces-pd deleted the docs/kerberos-multi-domain-winrm branch June 16, 2026 15:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants